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Purpose 


This action is used to get a pdf copy of the page. 


It does an on-the-fly, server-side, html to pdf conversion using htmldoc, and sends an application/pdf content 
to the web browser. 


Calling sequence 


http://my.server/MyWiki/MyPage?action=pdf 


http://my.server/MyWiki/MyPage?action=pdf&style=NAME 
http://my.server/MyWiki/MyPage?action=pdf&rev=NUM 


http://my.server/MyWiki/MyPage?action=pdf&pageact ion=ACTION 


http://my.server/MyWiki/MyPage?action=pdfé&help 


Style: 
0 page or book. These styles can be redefined or extended in the wiki config (see below). Asking for 
an unknown style will display an error and list available styles. 
rev: 
© Specifies a page version number. 
pageaction: 
© Specifies an action for rendering the page. By default and if omitted, the print action will be used. 
help: 
© Displays this help. 
Procedure 
Usage: 
e Append &saction=pdf to any URL 
e or insert the macro [ [pdf] ] (coming soon!) in a page, which will insert a small control panel 
Hints: 


e In book style, htmldoc automatically generates a table of contents. This can cause confusion if the 
[[TableOfContents]] macro is used. The TOC from htmldoc is looking nicer (has page numbers) but 
cannot be placed freely in the document. 
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Upon your liking, either 


tolerate dual TOCs, 


+ or adapt the wiki page for pdf book output: don't use the [ [TableOfContents] ] macro, 

+ or use the macro and disable htmldoc TOC globally: redefine the book style with the --no-toc 
option, 

+ or create a style (e.g book-notoc) having the --no-toc option. 


Suggestions: 


e Modify your themes to include a pdf link/icon besides print. 
e Modify the AttachFile standard action to add a pdf link. 


Installation 


1. install htmldoc on the wiki server (on a Debian box: apt-get install htmldoc) 
2. copy the_pdf.py action to the data/plugin/action directory of your wiki 


Optional: customizing styles 


To install new styles, or modify the default ones, edit wikiconfig.py and add: 


htmldoc_styles = { 


"page" : 
"—-verbos no-localfiles --no-compression --jpeg " \ 
"—-header t.D footer ./. --size a4 --left 0.5in " \ 
"--webpage", 

"book": 
"—-verbos no-localfiles no-compression jpeg " \ 
"--header t.D footer ./. --size a4 --left 0.5in", 


} 
By this means, you can change the page format from a4 to letter, or add new styles to the dictionary. 
For a complete list of available htmidoc options, see_http://www.easysw.com/htmldoc/docfiles/8—cmdref.html 
Modification History 


@copyright: 2006 by Pascal Bauermeister 
@license: GNU GPL, see COPYING for details. 
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